// 版权所有2012 Go作者。保留所有权利。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// 此文件实现对语句的类型检查。

package types2

import (
	"cmd/compile/internal/syntax"
	"go/constant"
	"sort"
)

func (check *Checker) funcBody(decl *declInfo, name string, sig *Signature, body *syntax.BlockStmt, iota constant.Value) {
	if check.conf.IgnoreFuncBodies {
		panic("function body not ignored")
	}

	if check.conf.Trace {
		check.trace(body.Pos(), "--- %s: %s", name, sig)
		defer func() {
			check.trace(syntax.EndPos(body), "--- <end>")
		}()
	}

	// 设置函数作用域范围
	sig.scope.pos = body.Pos()
	sig.scope.end = syntax.EndPos(body)

	// 保存/恢复当前环境并设置函数环境
	// （并在函数开始时使用0缩进）
	defer func(env environment, indent int) {
		check.environment = env
		check.indent = indent
	}(check.environment, check.indent)
	check.environment = environment{
		decl:  decl,
		scope: sig.scope,
		iota:  iota,
		sig:   sig,
	}
	check.indent = 0

	check.stmtList(0, body.List)

	if check.hasLabel && !check.conf.IgnoreLabels {
		check.labels(body)
	}

	if sig.results.Len() > 0 && !check.isTerminating(body, "") {
		check.error(body.Rbrace, "missing return")
	}

	// 规范：“实现限制：如果从未使用变量，编译器可能会将
	// 在函数体中声明变量设置为非法。”
	check.usage(sig.scope)
}

func (check *Checker) usage(scope *Scope) {
	var unused []*Var
	for name, elem := range scope.elems {
		elem = resolve(name, elem)
		if v, _ := elem.(*Var); v != nil && !v.used {
			unused = append(unused, v)
		}
	}
	sort.Slice(unused, func(i, j int) bool {
		return unused[i].pos.Cmp(unused[j].pos) < 0
	})
	for _, v := range unused {
		check.softErrorf(v.pos, "%s declared but not used", v.name)
	}

	for _, scope := range scope.children {
		// 不要第二次进入函数文字范围；
		// 它们由funcBody显式处理。
		if !scope.isFunc {
			check.usage(scope)
		}
	}
}

// stmtContext是一个位集，描述允许使用哪个
// 控制流语句，
// 并提供额外的上下文信息
// 以获得更好的错误消息。
type stmtContext uint

const (
	// 允许的控制流语句
	breakOk stmtContext = 1 << iota
	continueOk
	fallthroughOk

	// 附加上下文信息
	finalSwitchCase
)

func (check *Checker) simpleStmt(s syntax.Stmt) {
	if s != nil {
		check.stmt(0, s)
	}
}

func trimTrailingEmptyStmts(list []syntax.Stmt) []syntax.Stmt {
	for i := len(list); i > 0; i-- {
		if _, ok := list[i-1].(*syntax.EmptyStmt); !ok {
			return list[:i]
		}
	}
	return nil
}

func (check *Checker) stmtList(ctxt stmtContext, list []syntax.Stmt) {
	ok := ctxt&fallthroughOk != 0
	inner := ctxt &^ fallthroughOk
	list = trimTrailingEmptyStmts(list) // 尾部空语句对于故障分析是“不可见的”
	for i, s := range list {
		inner := inner
		if ok && i+1 == len(list) {
			inner |= fallthroughOk
		}
		check.stmt(inner, s)
	}
}

func (check *Checker) multipleSwitchDefaults(list []*syntax.CaseClause) {
	var first *syntax.CaseClause
	for _, c := range list {
		if c.Cases == nil {
			if first != nil {
				check.errorf(c, "multiple defaults (first at %s)", first.Pos())
				// TODO（gri）可能可以在第一个错误后跳出（并简化此代码）
			} else {
				first = c
			}
		}
	}
}

func (check *Checker) multipleSelectDefaults(list []*syntax.CommClause) {
	var first *syntax.CommClause
	for _, c := range list {
		if c.Comm == nil {
			if first != nil {
				check.errorf(c, "multiple defaults (first at %s)", first.Pos())
				// TODO（gri）可能可以在第一个错误后跳出（并简化此代码）
			} else {
				first = c
			}
		}
	}
}

func (check *Checker) openScope(node syntax.Node, comment string) {
	check.openScopeUntil(node, syntax.EndPos(node), comment)
}

func (check *Checker) openScopeUntil(node syntax.Node, end syntax.Pos, comment string) {
	scope := NewScope(check.scope, node.Pos(), end, comment)
	check.recordScope(node, scope)
	check.scope = scope
}

func (check *Checker) closeScope() {
	check.scope = check.scope.Parent()
}

func (check *Checker) suspendedCall(keyword string, call *syntax.CallExpr) {
	var x operand
	var msg string
	switch check.rawExpr(&x, call, nil, false) {
	case conversion:
		msg = "requires function call, not conversion"
	case expression:
		msg = "discards result of"
	case statement:
		return
	default:
		unreachable()
	}
	check.errorf(&x, "%s %s %s", keyword, msg, &x)
}

// goVal返回val的Go值，或nil。
func goVal(val constant.Value) interface{} {
	// val应该存在，但要保守，检查
	if val == nil {
		return nil
	}
	// 是否匹配其他编译器的实现限制。
	// gc只检查整数、浮点
	// 和字符串值的重复项，因此只为这些
	// 类型创建Go值。
	switch val.Kind() {
	case constant.Int:
		if x, ok := constant.Int64Val(val); ok {
			return x
		}
		if x, ok := constant.Uint64Val(val); ok {
			return x
		}
	case constant.Float:
		if x, ok := constant.Float64Val(val); ok {
			return x
		}
	case constant.String:
		return constant.StringVal(val)
	}
	return nil
}

// valueMap将一个案例值（基本Go类型）映射到一个位置列表
// ，其中出现了相同的案例值，以及相应的案例
// 类型。
// 由于两个case值可能具有相同的“基础”值，但不同的
// 类型，我们还需要检查值的类型（例如字节（1）与myByte（1））
// 当开关表达式为接口类型时。
type (
	valueMap  map[interface{}][]valueType // 基础Go值->值类型
	valueType struct {
		pos syntax.Pos
		typ Type
	}
)

func (check *Checker) caseValues(x *operand, values []syntax.Expr, seen valueMap) {
L:
	for _, e := range values {
		var v operand
		check.expr(&v, e)
		if x.mode == invalid || v.mode == invalid {
			continue L
		}
		check.convertUntyped(&v, x.typ)
		if v.mode == invalid {
			continue L
		}
		// 顺序问题：通过比较v和x，错误位置位于大小写值处。
		res := v // 保持原始v不变
		check.comparison(&res, x, syntax.Eql, true)
		if res.mode == invalid {
			continue L
		}
		if v.mode != constant_ {
			continue L // 我们完成了
		}
		// 查找重复值
		if val := goVal(v.val); val != nil {
			// 查找给定值的重复类型
			// （二次算法，但这些列表往往很短）
			for _, vt := range seen[val] {
				if Identical(v.typ, vt.typ) {
					var err error_
					err.errorf(&v, "duplicate case %s in expression switch", &v)
					err.errorf(vt.pos, "previous case")
					check.report(&err)
					continue L
				}
			}
			seen[val] = append(seen[val], valueType{v.Pos(), v.typ})
		}
	}
}

// isNil报告表达式e是否表示预声明的值nil。
func (check *Checker) isNil(e syntax.Expr) bool {
	// 表示nil值的唯一方法是直接写nil（可能在括号中）。
	if name, _ := unparen(e).(*syntax.Name); name != nil {
		_, ok := check.lookup(name.Value).(*Nil)
		return ok
	}
	return false
}

// 如果类型开关表达式无效，则x为零。
func (check *Checker) caseTypes(x *operand, types []syntax.Expr, seen map[Type]syntax.Expr) (T Type) {
	var dummy operand
L:
	for _, e := range types {
		// 规范允许值nil而不是类型。
		if check.isNil(e) {
			T = nil
			check.expr(&dummy, e) // 通过expr运行e，这样我们就可以得到通常的信息记录
		} else {
			T = check.varType(e)
			if T == Typ[Invalid] {
				continue L
			}
		}
		// 寻找重复类型
		// （二次算法，但类型开关往往相当小）
		for t, other := range seen {
			if T == nil && t == nil || T != nil && t != nil && Identical(T, t) {
				// 谈论“case”而不是“type”，因为无case 
				Ts := "nil"
				if T != nil {
					Ts = TypeString(T, check.qualifier)
				}
				var err error_
				err.errorf(e, "duplicate case %s in type switch", Ts)
				err.errorf(other, "previous case")
				check.report(&err)
				continue L
			}
		}
		seen[T] = e
		if x != nil && T != nil {
			check.typeAssertion(e, x, T, true)
		}
	}
	return
}

// TODO（gri）一旦我们确定typeHash在所有情况下都是正确的，改用这个版本的案例类型。
// （由于ImporterFrom，目前可能不同类型具有相同的名称和导入路径。）
// 
// func（check*Checker）caseTypes（x*操作数，xtyp*接口，types[]syntax.Expr，seen map[string]syntax.Expr，seen map[string]syntax.Expr）（T Type）{
// var伪操作数
// L:
// /规范允许值nil而不是类型。
// var hash string 
// if check.isNil（e）{
// check.expr（&dummy，e）
// T=nil 
// hash=“<nil>”
// T=check.varType（e）
// if T==Typ[Invalid]{
// continue L 
// }
// hash=typeHash（T，nil）
// }
// /如果其他：=seed[hash]；其他！=nil{
// /谈论“case”而不是“type”，因为nil case 
// Ts:=“nil”
// /如果T！=nil{
// Ts=TypeString（T，check.qualifier）
// }。错误（e，“类型开关中的重复案例%s”，Ts）
// 错误。errorf（其他，“先前案例”）
// 检查。报告（&err）
// 继续L 
// /}
// 看到[hash]=e 
// 如果T！=nil{
// check.typeAssertion（e，x，xtyp，T，true）
// }
// }
// return 
// }

// stmt typechecks语句。
func (check *Checker) stmt(ctxt stmtContext, s syntax.Stmt) {
	// 语句必须以与
	if debug {
		defer func(scope *Scope) {
			if p := recover(); p != nil {
				panic(p)
			}
			assert(scope == check.scope)
		}(check.scope)
	}

	defer check.processDelayed(len(check.delayed))

	inner := ctxt &^ (fallthroughOk | finalSwitchCase)
	switch s := s.(type) {
	case *syntax.EmptyStmt:
		// 忽略

	case *syntax.DeclStmt:
		check.declStmt(s.DeclList)

	case *syntax.LabeledStmt:
		check.hasLabel = true
		check.stmt(ctxt, s.Stmt)

	case *syntax.ExprStmt:
		// 规范：“除了特定的内置函数外，
		// 函数和方法调用以及接收操作可以在语句上下文中出现
		// 这类语句可以用括号括起来。”
		var x operand
		kind := check.rawExpr(&x, s.X, nil, false)
		var msg string
		switch x.mode {
		default:
			if kind == statement {
				return
			}
			msg = "is not used"
		case builtin:
			msg = "must be called"
		case typexpr:
			msg = "is not an expression"
		}
		check.errorf(&x, "%s %s", &x, msg)

	case *syntax.SendStmt:
		var ch, val operand
		check.expr(&ch, s.Chan)
		check.expr(&val, s.Value)
		if ch.mode == invalid || val.mode == invalid {
			return
		}
		u := coreType(ch.typ)
		if u == nil {
			check.errorf(s, invalidOp+"cannot send to %s: no core type", &ch)
			return
		}
		uch, _ := u.(*Chan)
		if uch == nil {
			check.errorf(s, invalidOp+"cannot send to non-channel %s", &ch)
			return
		}
		if uch.dir == RecvOnly {
			check.errorf(s, invalidOp+"cannot send to receive-only channel %s", &ch)
			return
		}
		check.assignment(&val, uch.elem, "send")

	case *syntax.AssignStmt:
		lhs := unpackExpr(s.Lhs)
		if s.Rhs == nil {
			// x++或x--
			if len(lhs) != 1 {
				check.errorf(s, invalidAST+"%s%s requires one operand", s.Op, s.Op)
				return
			}
			var x operand
			check.expr(&x, lhs[0])
			if x.mode == invalid {
				return
			}
			if !allNumeric(x.typ) {
				check.errorf(lhs[0], invalidOp+"%s%s%s (non-numeric type %s)", lhs[0], s.Op, s.Op, x.typ)
				return
			}
			check.assignVar(lhs[0], &x)
			return
		}

		rhs := unpackExpr(s.Rhs)
		switch s.Op {
		case 0:
			check.assignVars(lhs, rhs)
			return
		case syntax.Def:
			check.shortVarDecl(s.Pos(), lhs, rhs)
			return
		}

		// 赋值操作
		if len(lhs) != 1 || len(rhs) != 1 {
			check.errorf(s, "assignment operation %s requires single-valued expressions", s.Op)
			return
		}

		var x operand
		check.binary(&x, nil, lhs[0], rhs[0], s.Op)
		check.assignVar(lhs[0], &x)

	case *syntax.CallStmt:
		kind := "go"
		if s.Tok == syntax.Defer {
			kind = "defer"
		}
		check.suspendedCall(kind, s.Call)

	case *syntax.ReturnStmt:
		res := check.sig.results
		// 返回带有指定结果的函数所允许的隐式结果。
		// /（如果一个被命名，所有的都被命名。）
		results := unpackExpr(s.Results)
		if len(results) == 0 && res.Len() > 0 && res.vars[0].name != "" {
			// spec:“实现限制：如果在返回位置的作用域中有另一个实体（常量、类型或变量）
			// 列表。”
			// 与结果参数同名，编译器可能不允许在“return”语句中使用空表达式
			for _, obj := range res.vars {
				if alt := check.lookup(obj.name); alt != nil && alt != obj {
					var err error_
					err.errorf(s, "result parameter %s not in scope at return", obj.name)
					err.errorf(alt, "inner declaration of %s", obj)
					check.report(&err)
					// 确定继续
				}
			}
		} else {
			var lhs []*Var
			if res.Len() > 0 {
				lhs = res.vars
			}
			check.initVars(lhs, results, s)
		}

	case *syntax.BranchStmt:
		if s.Label != nil {
			check.hasLabel = true
			break // 第二次通过检查（check.labels）
		}
		switch s.Tok {
		case syntax.Break:
			if ctxt&breakOk == 0 {
				if check.conf.CompilerErrorMessages {
					check.error(s, "break is not in a loop, switch, or select statement")
				} else {
					check.error(s, "break not in for, switch, or select statement")
				}
			}
		case syntax.Continue:
			if ctxt&continueOk == 0 {
				if check.conf.CompilerErrorMessages {
					check.error(s, "continue is not in a loop")
				} else {
					check.error(s, "continue not in for statement")
				}
			}
		case syntax.Fallthrough:
			if ctxt&fallthroughOk == 0 {
				msg := "fallthrough statement out of place"
				if ctxt&finalSwitchCase != 0 {
					msg = "cannot fallthrough final case in switch"
				}
				check.error(s, msg)
			}
		case syntax.Goto:
			// goto必须有标签，应该在
			fallthrough
		default:
			check.errorf(s, invalidAST+"branch statement: %s", s.Tok)
		}

	case *syntax.BlockStmt:
		check.openScope(s, "block")
		defer check.closeScope()

		check.stmtList(inner, s.List)

	case *syntax.IfStmt:
		check.openScope(s, "if")
		defer check.closeScope()

		check.simpleStmt(s.Init)
		var x operand
		check.expr(&x, s.Cond)
		if x.mode != invalid && !allBoolean(x.typ) {
			check.error(s.Cond, "non-boolean condition in if statement")
		}
		check.stmt(inner, s.Then)
		// 上面被捕获解析器生成正确的AST，但如果它被修改
		// 其他地方的else分支可能无效。再查一遍。
		switch s.Else.(type) {
		case nil:
			// 有效或已报告错误
		case *syntax.IfStmt, *syntax.BlockStmt:
			check.stmt(inner, s.Else)
		default:
			check.error(s.Else, "invalid else branch in if statement")
		}

	case *syntax.SwitchStmt:
		inner |= breakOk
		check.openScope(s, "switch")
		defer check.closeScope()

		check.simpleStmt(s.Init)

		if g, _ := s.Tag.(*syntax.TypeSwitchGuard); g != nil {
			check.typeSwitchStmt(inner, s, g)
		} else {
			check.switchStmt(inner, s)
		}

	case *syntax.SelectStmt:
		inner |= breakOk

		check.multipleSelectDefaults(s.Body)

		for i, clause := range s.Body {
			if clause == nil {
				continue // 在
			}

			// 子句之前报告的错误。Comm必须是sendsmt、RecvStmt或默认值
			valid := false
			var rhs syntax.Expr // rhs of RecvStmt，或nil 
			switch s := clause.Comm.(type) {
			case nil, *syntax.SendStmt:
				valid = true
			case *syntax.AssignStmt:
				if _, ok := s.Rhs.(*syntax.ListExpr); !ok {
					rhs = s.Rhs
				}
			case *syntax.ExprStmt:
				rhs = s.X
			}

			// 如果存在，rhs必须是接收操作
			if rhs != nil {
				if x, _ := unparen(rhs).(*syntax.Operation); x != nil && x.Y == nil && x.Op == syntax.Recv {
					valid = true
				}
			}

			if !valid {
				check.error(clause.Comm, "select case must be send or receive (possibly with assignment)")
				continue
			}
			end := s.Rbrace
			if i+1 < len(s.Body) {
				end = s.Body[i+1].Pos()
			}
			check.openScopeUntil(clause, end, "case")
			if clause.Comm != nil {
				check.stmt(inner, clause.Comm)
			}
			check.stmtList(inner, clause.Body)
			check.closeScope()
		}

	case *syntax.ForStmt:
		inner |= breakOk | continueOk

		if rclause, _ := s.Init.(*syntax.RangeClause); rclause != nil {
			check.rangeStmt(inner, s, rclause)
			break
		}

		check.openScope(s, "for")
		defer check.closeScope()

		check.simpleStmt(s.Init)
		if s.Cond != nil {
			var x operand
			check.expr(&x, s.Cond)
			if x.mode != invalid && !allBoolean(x.typ) {
				check.error(s.Cond, "non-boolean condition in for statement")
			}
		}
		check.simpleStmt(s.Post)
		// spec:“init语句可以是短变量
		// 声明，但post语句不能。”
		if s, _ := s.Post.(*syntax.AssignStmt); s != nil && s.Op == syntax.Def {
			// 解析器已报告错误。
			check.use(s.Lhs) // 避免后续错误
		}
		check.stmt(inner, s.Body)

	default:
		check.error(s, "invalid statement")
	}
}

func (check *Checker) switchStmt(inner stmtContext, s *syntax.SwitchStmt) {
	// init语句已经处理了

	var x operand
	if s.Tag != nil {
		check.expr(&x, s.Tag)
		// 通过检查x的赋值给一个不可见的临时
		// （就像编译器会做的那样），我们得到了所有相关的检查。
		check.assignment(&x, nil, "switch expression")
		if x.mode != invalid && !Comparable(x.typ) && !hasNil(x.typ) {
			check.errorf(&x, "cannot switch on %s (%s is not comparable)", &x, x.typ)
			x.mode = invalid
		}
	} else {
		// 规范：“缺少的开关表达式是
		// 等效于布尔值true。”
		x.mode = constant_
		x.typ = Typ[Bool]
		x.val = constant.MakeBool(true)
		// TODO（gri）应该在这里有一个更好的位置
		pos := s.Rbrace
		if len(s.Body) > 0 {
			pos = s.Body[0].Pos()
		}
		x.expr = syntax.NewName(pos, "true")
	}

	check.multipleSwitchDefaults(s.Body)

	seen := make(valueMap) // SEED大小写值到位置和类型的映射
	for i, clause := range s.Body {
		if clause == nil {
			check.error(clause, invalidAST+"incorrect expression switch case")
			continue
		}
		end := s.Rbrace
		inner := inner
		if i+1 < len(s.Body) {
			end = s.Body[i+1].Pos()
			inner |= fallthroughOk
		} else {
			inner |= finalSwitchCase
		}
		check.caseValues(&x, unpackExpr(clause.Cases), seen)
		check.openScopeUntil(clause, end, "case")
		check.stmtList(inner, clause.Body)
		check.closeScope()
	}
}

func (check *Checker) typeSwitchStmt(inner stmtContext, s *syntax.SwitchStmt, guard *syntax.TypeSwitchGuard) {
	// init语句已经处理过

	// type switch-guard的格式必须是：
	// 
	// TypeSwitchGuard=[identifier:“]PrimaryExpr”（“类型”）。
	// /\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\，如果任何

	lhs := guard.Lhs
	if lhs != nil {
		if lhs.Value == "_" {
			// /:=x.（类型）是无效的短变量声明
			check.softErrorf(lhs, "no new variable on left side of :=")
			lhs = nil // 避免声明但未使用错误
		} else {
			check.recordDef(lhs, nil) // lhs变量在每个cause子句中隐式声明
		}
	}

	// 检查rhs 
	var x operand
	check.expr(&x, guard.X)
	if x.mode == invalid {
		return
	}

	// TODO（gri）我们可能希望允许在某个点对类型参数值进行类型切换
	var sx *operand // 切换与案例进行对比的表达方式；nil if invalid 
	if isTypeParam(x.typ) {
		check.errorf(&x, "cannot use type switch on type parameter value %s", &x)
	} else {
		if _, ok := under(x.typ).(*Interface); ok {
			sx = &x
		} else {
			check.errorf(&x, "%s is not an interface", &x)
		}
	}

	check.multipleSwitchDefaults(s.Body)

	var lhsVars []*Var                 // 隐式声明的lhs变量列表
	seen := make(map[Type]syntax.Expr) // 看到的类型到位置的映射
	for i, clause := range s.Body {
		if clause == nil {
			check.error(s, invalidAST+"incorrect type switch case")
			continue
		}
		end := s.Rbrace
		if i+1 < len(s.Body) {
			end = s.Body[i+1].Pos()
		}
		// 检查此类型开关中的每个类型。
		cases := unpackExpr(clause.Cases)
		T := check.caseTypes(sx, cases, seen)
		check.openScopeUntil(clause, end, "case")
		// 如果lhs存在，在case local scope中声明一个相应的变量。
		if lhs != nil {
			// 规格：“TypeSwitchGuard可能包含一个简短的变量声明。使用该格式时，变量在每个子句中的隐式块的开头声明。在大小写为
			// 的子句中，只有一个类型的变量具有该类型；否则，变量
			// 具有类型中表达式的类型。”女巫守卫。“
			if len(cases) != 1 || T == nil {
				T = x.typ
			}
			obj := NewVar(lhs.Pos(), check.pkg, lhs.Value, T)
			// TODO（mdempsky）：只使用子句.冒号？为什么我甚至在#16794中建议
			// ”放在TypeSwitchCase的末尾？
			scopePos := clause.Pos() // /作为默认子句（len（List）==0）
			if n := len(cases); n > 0 {
				scopePos = syntax.EndPos(cases[n-1])
			}
			check.declare(check.scope, nil, obj, scopePos)
			check.recordImplicit(clause, obj)
			// /作为“声明但未使用的”“错误，所有lhs变量都充当
			// 一个；也就是说，如果其中任何一个被‘使用’，所有的变量都被‘使用’。
			// 收集它们以备以后分析。
			lhsVars = append(lhsVars, obj)
		}
		check.stmtList(inner, clause.Body)
		check.closeScope()
	}

	// 如果lhs存在，我们必须至少有一个使用过的lhs变量。
	// ”（我们不能使用check.usage，因为它只查看一个作用域；而
	// 我们不想对所有作用域使用同一个变量，并在下面更改
	// 变量类型。）
	if lhs != nil {
		var used bool
		for _, v := range lhsVars {
			if v.used {
				used = true
			}
			v.used = true // 检查整个函数时避免使用错误
		}
		if !used {
			check.softErrorf(lhs, "%s declared but not used", lhs.Value)
		}
	}
}

func (check *Checker) rangeStmt(inner stmtContext, s *syntax.ForStmt, rclause *syntax.RangeClause) {
	// 确定lhs，如果任何
	sKey := rclause.Lhs // 可能为零
	var sValue, sExtra syntax.Expr
	if p, _ := sKey.(*syntax.ListExpr); p != nil {
		if len(p.ElemList) < 2 {
			check.error(s, invalidAST+"invalid lhs in range clause")
			return
		}
		// len（p.ElemList）>=2 
		sKey = p.ElemList[0]
		sValue = p.ElemList[1]
		if len(p.ElemList) > 2 {
			// 延迟错误报告，直到我们了解更多
			sExtra = p.ElemList[2]
		}
	}

	// 检查表达式以迭代
	var x operand
	check.expr(&x, rclause.X)

	// 确定键/值类型
	var key, val Type
	if x.mode != invalid {
		// 如果类型参数具有核心类型，则允许对其进行范围调整。
		var cause string
		u := coreType(x.typ)
		if t, _ := u.(*Chan); t != nil {
			if sValue != nil {
				check.softErrorf(sValue, "range over %s permits only one iteration variable", &x)
				// 确定继续
			}
			if t.dir == SendOnly {
				cause = "receive from send-only channel"
			}
		} else {
			if sExtra != nil {
				check.softErrorf(sExtra, "range clause permits at most two iteration variables")
				// 确定继续
			}
			if u == nil {
				cause = check.sprintf("%s has no core type", x.typ)
			}
		}
		key, val = rangeKeyVal(u)
		if key == nil || cause != "" {
			if cause == "" {
				check.softErrorf(&x, "cannot range over %s", &x)
			} else {
				check.softErrorf(&x, "cannot range over %s (%s)", &x, cause)
			}
			// 确定继续
		}
	}

	// 立即在range子句之后打开for语句块scope。
	// 用声明的迭代变量：=需要进入这个范围（was问题#51437）。
	check.openScope(s, "range")
	defer check.closeScope()

	// 检查迭代变量的赋值/声明
	// （不规则赋值，无法轻松映射到现有赋值检查）

	// lhs表达式和初始化值（rhs）类型
	lhs := [2]syntax.Expr{sKey, sValue}
	rhs := [2]Type{key, val} // 键，val可能为零

	if rclause.Def {
		// 短变量声明
		var vars []*Var
		for i, lhs := range lhs {
			if lhs == nil {
				continue
			}

			// 确定lhs变量
			var obj *Var
			if ident, _ := lhs.(*syntax.Name); ident != nil {
				// 声明新变量
				name := ident.Value
				obj = NewVar(ident.Pos(), check.pkg, name, nil)
				check.recordDef(ident, obj)
				// /uu变量不算作新变量
				if name != "_" {
					vars = append(vars, obj)
				}
			} else {
				check.errorf(lhs, "cannot declare %s", lhs)
				obj = NewVar(lhs.Pos(), check.pkg, "_", nil) // 伪变量
			}

			// 初始化lhs变量
			if typ := rhs[i]; typ != nil {
				x.mode = value
				x.expr = lhs // 我们这里没有更好的rhs表达式
				x.typ = typ
				check.initVar(obj, &x, "range clause")
			} else {
				obj.typ = Typ[Invalid]
				obj.used = true // 不要抱怨未使用的变量
			}
		}

		// 声明变量
		if len(vars) > 0 {
			scopePos := s.Body.Pos()
			for _, obj := range vars {
				check.declare(check.scope, nil /* recordDef already called */, obj, scopePos)
			}
		} else {
			check.error(s, "no new variables on left side of :=")
		}
	} else {
		// 普通赋值
		for i, lhs := range lhs {
			if lhs == nil {
				continue
			}
			if typ := rhs[i]; typ != nil {
				x.mode = value
				x.expr = lhs // 这里没有更好的rhs表达式
				x.typ = typ
				check.assignVar(lhs, &x)
			}
		}
	}

	check.stmt(inner, s.Body)
}

// rangeKeyVal返回range子句
// 在typ类型的表达式上生成的键和值类型。如果range子句不允许
// 则结果为零。
func rangeKeyVal(typ Type) (key, val Type) {
	switch typ := arrayPtrDeref(typ).(type) {
	case *Basic:
		if isString(typ) {
			return Typ[Int], universeRune // 使用“符文”名称
		}
	case *Array:
		return Typ[Int], typ.elem
	case *Slice:
		return Typ[Int], typ.elem
	case *Map:
		return typ.key, typ.elem
	case *Chan:
		return typ.elem, Typ[Invalid]
	}
	return
}
